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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part the 32.300-series covering the 3'^'' Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication Management; Notification Management, as identified below: 

32.301: "Notification Integration Reference Point: Requirements"; 

32.302: "Notification Integration Reference Point: Information Service Version 2"; 

32.303: "Notification Integration Reference Point: CORBA Solution Set Version 2:1"; 

32.304: "Notification Integration Reference Point: CMIP Solution Set Version 2:1"; 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality Of Service (QOS). The CM actions 
are initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 

The Itf-N interface is built up by a number of Integration Reference Points (IRPs) and a related Name Convention, 
which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
3GPP TS 32.101 [5] and 3GPP TS 32.102 [6]. 

Network Elements (NEs) under management and element managers generate notifications of events about occurrences 
within the network. Different kinds of events carry different kinds of information. For instance a new alarm as 
specified in Alarm IRP: Information Service [1], is one possible kind of event, an object creation as specified in Basic 
CM IRP: Information Service [8] is another possible kind of event. 

Information of an event is carried in notification. An IRP Agent (typically an EM or a NE) emits notifications. 
IRPManager (typically a network management system) receives notifications. The purpose of Notification IRP is to 
define an interface through which an IRPManager can subscribe to IRP Agent for receiving notifications. 
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This IRP bases its design on work captured in ITU-T Recommendation X.734 [2], OMG Notification Service [4]. The 
central design ideas are: 

• Separation of notification Consumers (IRPManagers) from Producers (IRP Agents); 

Notifications are sent to IRPManagers without the need for IRPManagers to periodically check for new notifications. 



Common characteristics related to notifications in all other IRPs are gathered in one IRP. 
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Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in Notification IRP: Information Service [5]. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] ITU-T Recommendation X.736: "Security Alarm Reporting Function". 

[2] OMG TC Document telecom (98-11-01): "OMG Notification Service". 

[3] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

(Clause 4 contains the Event Service Specification.) 

[4] 3GPP TS 32.3 12: "Generic IRP Management: Information Service". 

[5] 3GPP TS 32.302: "Notification IRP: Information Service". 

[6] 3GPPTS 32.111-2: "Alarm IRP: Information Service". 

[7] 3GPP TS 32.101: "3G Telecom Management principles and high level requirements". 

[8] 3GPP TS 32.102: "3G Telecom Management architecture". 

[9] 3GPP TS 32.301: "Notification IRP: Requirements". 

[10] 3GPP TS 32.1 1 1-3: "Alarm IRP: CORBA Solution Set". 

[II] 3GPP TS 32.3 1 1 : "Generic IRP Management: Information Service" 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply. Please refer to 3GPP TS 32.10 
[7], 3GPP TS 32.102 [8] and 3GPP TS 32.301 [9]. 

IRP document version number string (or "IRP Version"). See 3GPP TS 32.31 1 [11]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture (OMG) 
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EC 

IDL 

IS 

lOR 

NC 

NE 

NV 

EM 

OMG 

QoS 

SS 

UML 



Event channel (OMG) 

Interface Definition Language (OMG) 

Information Service 

Interoperable Object Reference 

Notification Channel (OMG) 

Network Element 

Name and Value pair 

Element Manager 

Object Management Group 

Quality of Service 

Solution Set 

Unified Modelling Language (OMG) 



4 Architectural features 

The overall architectural feature of Notification IRP is specified in 3GPP TS 32.302 [5]. This clause specifies features 
that are specific to the CORBA Solution Set (SS). 



4.1 



Notification services 



In the CORBA Solution Set, notifications are emitted by IRP Agent using CORBA Notification service (OMG TC 
Document telecom [2]). 

CORBA Event service (OMG CORBA services [3]) provides event routing and distribution capabilities. CORBA 
Notification service provides, in addition to Event service, event filtering and support for Quality of Service (QoS) as 
well. 

A subset of CORBA Notification services shall be used to support the implementation of notification. This CORBA 
Notification service subset, in terms of OMG Notification service (OMG TC Document telecom [2]) defined methods, 
is identified in the present. 

4.1 .1 Support of Push and Pull Interface 

The IRP Agent shall support the OMG Notification push interface model. Additionally, it may support the OMG 
Notification pull interface model as well. 

4.1 .2 Support of multiple notifications in one push operation 

For efficiency, IRP Agent uses the following OMG Notification Service (OMG TC Document telecom [2]) defined 
interface to pack multiple notifications and push them to IRPManager using one method 

push_structured_events. The method takes as input a parameter of type EventBatch as defined in the OMG 
CosNotif ication module (OMG TC Document telecom [2]). This data type is a sequence of Structured Events 
(see clause 4). Upon invocation, this parameter will contain a sequence of Structured Events being delivered to 
IRPManager by IRP Agent to which it is connected. 

The maximum number of events that will be transmitted within a single invocation of this operation is controlled by 
IRP Agent wide configuration parameter. The amount of time IRP Agent will accumulate individual events into the 
sequence before invoking this operation is controlled by IRP Agent wide configuration parameter as well. 

IRP Agent may push EventBatch with only one Structured Event. 

The OMG Notification service (OMG TC Document telecom [2]) defined IDL module is shown below. 

module CosNotifyComm ( 

Interface SequencePushConsumer : NotifyPublish { 
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void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises ( CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

5 Mapping 

5.1 Operation mapping 

Notification IRP: IS (3GPP TS 32.302 [5]) defines semantics of operations visible across this IRP. These operations are 
the operations of the lOCs defined in [5]. 

Table 1 maps the operations defined in Notification IRP: IS (3GPP TS 32.302 [5]) to their equivalents (methods) in this 
Solution Set (SS). Specifically, the table 1 maps the operations of the lOCs defined in [5] to their equivalents in this 
SS. Since one of the lOCs, the Notif icationIRP IOC, inherits from the ManagedGenericIRP IOC [4], the 
table 1 also maps the operations of ManagedGenericIRP IOC to their equivalents (methods) in this SS. 

The table 1 also qualifies if a method is Mandatory (M) or Optional (O) 
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Table 1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 
3GPP TS 32.302 [5] 


SS IVIethods 


Qualifier 


subscribe 


attach push, attach push b, attach pull 


M, 0, 


unsubscribe 


detach 


M 


getlRPVersion (see note.) 


get notification IRP version 


M 


getSubscriptionStatus 


get subscription status 





getSubscriptionlds 


get subscription ids 





cliangeSubscriptionFilter 


If subscription is established using attach_push method, the SS equivalent 
shall be change_subscription_filter. The IDL specification of this method is 
included in Annex A. This method is Optional (0). 

If subscription is established using attach_push_b method, the SS 
equivalent shall be modify_constraints. The method is defined in OMG 
Notification Service Filter Interface (OIVIG TC Document telecom [2]). The 
IDL specification of this method is not included in Annex A. If IRPAgent 
supports the optional attach_push_b method, it shall support this method 
as mandatory. 

If subscription is established using attach_pull method, the SS equivalent 
shall be modify_constraints. The method is defined by OIVIG Notification 
Service Filter Interface (OMG TC Document telecom [2]). The IDL 
specification of this method is not included in Annex A. If IRPAgent 
supports the optional attach_pull method, it shall support this method as 
mandatory. 


See box on 
the left. 


suspendSubscription 


If subscription is established using attach_push, there is no SS equivalent. 
In other words, IRPManager cannot suspend subscription. 

If subscription is established using attach_push_b, the SS equivalent shall 
be suspend_connection. This method is defined by OMG Notification 
Service (OMG TC Document telecom [2]). The IDL specification of this 
method is not included in Annex A. If IRPAgent supports the optional 
attach_push_b method, it shall support this method as mandatory. 

If subscription is established using attach pull, there is no SS equivalent. 


See box on 
the left 


resumeSubscription 


If subscription is established using attach_push, there is no SS equivalent. 
In other words, IRPManager cannot resume subscription. 

If subscription is established using attach_push_b, the SS equivalent shall 
be resume_connection. This method is defined by OMG Notification 
Service (OMG TC Document telecom [2]). The IDL specification of this 
method is not included in Annex A. If IRPAgent supports the optional 
attach_push_b method, it shall support this method as mandatory. 

If subscription is established using attach pull, there is no SS equivalent. 


See box on 
the left 


getNotificationCategories 


get notification categories 





getOperationProfile (see 
note.) 


get_notification_IRP_operation_profile 





getNotificationProfile (see 
note.) 


get_notification_IRP_notification_profile 





NOTE: These 3 operations are operations of IVIanagedGenericIRP IOC specified in [4]. The NotificationIRP IOC of [5] 
inherits from it. 



5.2 Operation parameter mapping 



3GPP TS 32.302 [5] defines semantics of parameters carried in operations across the Notification IRP. Table 2 through 
table 14 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 
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Table 2: Mapping from IS subscribe parameters to SS attach_push equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference (see NOTE 1) 


M 


timelick 


long time tick 





notification Categories 


NotificationlRPConstDefs::NotificationCategorySet notification category set 





filter 


string filter (see NOTE 2) 





subscriptionid 


Return value of type NotificationlRPConstDefs::Subscriptionld 


M 


status 


Attach, ParameterNotSupported, InvalidParameter, AlreadySubscribed, 
AtLeastOneNotificationCategoryNotSupported 


M 


NOTE 1 : IRPIVIanager creates a CosNotifyComm::SequencePushConsumer object and invol<es 

CORBA::ORB::object_to_string to obtain the stringified lOR, say s1 . IRPIVIanager stores the s1 . IRPIVIanager 
sends s1 as input parameter of attach_push to IRPAgent. IRPAgent receives s1 , performs 
CORBA::ORB::string_to_object to obtain the IRPManager's lOR and uses it for its future methods. IRPAgent 
also stores the s1 for future comparisons. IRPIVIanager later calls detach with s1 . IRPAgent receives the 
stringified lOR s1 , compares it with those stored stringified lORs (e.g., s1 ), finds a match, and performs the 
detach process. IRPAgent pushes sequence of Structured Events towards IRPIVIanager via the 
CosNotifyComm::SequencePushConsumer object push_structured_events method, depending on the 
supplied notification categories and filter. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OIVIG Notification Service (OMG TC Document 
telecom [2]). This SS and the Alarm IRP: CORBA SS [10] shall use this grammar only.. 



Table 3: Mapping from IS subscribe parameters to SS attach_push_b equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference (see NOTE 1) 


M 


timeTick 


long time tick 





notification Categories 


NotificationlRPConstDefs::NotificationCategorySet notification category set 





filter 


string filter (see NOTE 2) 





subscriptionid 


Return value of type NotificationlRPConstDefs::Subscriptionld 


M 


Not specified in IS 


CosNotifyChannelAdmin::SequenceProxyPushSupplier system reference 
(see NOTE 3) 


M 


status 


Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, 
AlreadySubscribed, AtLeastOneNotificationCategoryNotSupported 


M 


NOTE 1 : IRPManager creates a CosNotifyComm::SequencePushConsumer object and invokes 

CORBA::ORB::object_to_string to obtain the stringified lOR, say si . IRPManager stores the si . IRPManager 
sends si as input parameter of attach_push_b to IRPAgent. IRPAgent receives s1 and stores the s1 for 
future comparisons. IRPManager later calls detach with s1 . IRPAgent receives the stringified lOR s1 , 
compares it with those stored stringified lORs (e.g., s1), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This SS and the Alarm IRP: CORBA SS [10] shall use this grammar only. 

NOTE 3: IRPAgent provides this reference to which IRPManager can invoke methods to manage the subscription. 

Valid methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read 
interface CosNotifyChannelAdmin::SequenceProxyPushSupplier and 
CosNotifyComm::SequencePushConsumer. IRPManager is expected to invoke 
connect_sequence_push_consumer method of this interface to connect its own 

cosNotifyComm::SequencePushConsummer with this reference. After successful connection, IRPAgent 
pushes sequence of Structured Events towards IRPManager. 
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Table 4: Mapping from IS subscribe parameters to SS attach_pull equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference (see NOTE 1) 


M 


timelick 


long time tick 





notification Categories 


NotificationlRPConstDefs::NotificationCategorySet notification category set 





filter 


string filter (see NOTE 2) 





subscriptionid 


Return value of type NotificationlRPConstDefs::Subscriptionld 


M 


Not specified in IS. 


CosNotifyChannelAdmin::SequenceProxyPullSupplier system reference (see 
NOTE 3) 


M 


status 


Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, 
AlreadySubscribed, AtLeastOneNotificationCategoryNotSupported 


M 


NOTE 1 : IRPManager creates a CosNotifyComm::SequencePullConsumer object and invokes 

CORBA::ORB::object_to_string to obtain the stringified lOR, say s1 . IRPManager stores the s1 . IRPIVIanager 
sends s1 as input parameter of attach_pull to IRPAgent. IRPAgent receives s1 and stores the s1 for future 
comparisons. IRPManager later calls detach with s1 . IRPAgent receives the stringified lOR s1 , compares it 
with those stored stringified lORs (e.g., s1), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This SS and the Alarm IRP: CORBA SS [10] shall use this grammar only. 

NOTE 3: IRPAgent provides this reference to which IRPManager can invoke methods to manage the subscription. 

Valid methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read 
interface CosNotifyChannelAdmin::SequenceProxyPullSupplier and 
CosNotifyComm::SequencePullConsumer. IRPManager is expected to invoke 
connect_sequence_pull_consumer method of this interface to connect its own 

CosNotifyComm::SequencePullConsummerwith this reference. After successful connection, IRPManager 
pulls sequence of Structured Events from IRPAgent. 



Table 5: IVIapping from IS unsubscribe parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference 


M 


subscriptionid 


NotificationlRPConstDefs::Subscriptionld subscription id 





status 


Detach, InvalidParameter 


M 



Table 6: Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 



SS Method parameter 



Qualifier 



versionNumberList 



Return value of type CommonlRPConstDefs::VersionNumberSet 



M 



iGetNotificationlRPVersion \M 

Table 7: Mapping from IS getsubscriptionstatus parameters to SS equivalents 



status 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscriptionid 


NotificationlRPConstDefs::Subscriptionld subscription id 


M 


notificationCategory 
List 


Return value of type NotificationlRPConstDefs::NotificationCategorySet 


M 


filterlnEffect 


string filter in effect 





subscriptionState 


NotificationlRPConstDef::SubscriptionState subscription state 





timeTick 


long time tick 





status 


GetSubscriptionStatus, OperationNotSupported, InvalidParameter 


M 



Table 8: Mapping from IS getSubscriptionids parameters to SS equivalents 



IS Operation parameter 



string manager_reference 



SS Method parameter 



Qualifier 



managerReference 



Return value of type NotificationlRPConstDefs::SubscriptionldSet 



M 



subscription IdList 



GetSubscriptionlds,OperationNotSupported, InvalidParameter 



M 



status 



M 
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Table 9: Mapping from IS changeSubscriptionFilter parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscription Id 


NotificationlRPConstDefs::Subscriptionld subscription id 


M 


filter 


string filter 


M 


status 


ChangeSubscriptJonFJIter,OperationNotSupported,lnvalidParameter 


M 



Table 10: Mapping from IS suspendSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscription Id 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OIVIG Notification Service 

(OMG TC Document telecom [2]) and requires no parameter. Therefore, there 

is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OIVIG Notification Service 

(OMG TO Document telecom [2]) and it returns a void. Therefore, there is no 

SS equivalent for this IS parameter. This suspend_connection method can raise 

OIVIG Notification Service (OMG TC Document telecom [2]) defined exception 

called ConnectionAlreadylnactive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 11 : Mapping from IS resumeSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification Service (OMG 

TC Document telecom [2]) and requires no parameter. Therefore, there is no SS 

equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification Service (OMG 

TC Document telecom [2]) and returns a void. Therefore, there is no SS 

equivalent for this IS parameter. This resume_connection method can raise 

OMG Notification Service (OMG TC Document telecom [2]) defined exception 

called ConnectionAlreadyActive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 12: Mapping from IS getNotif icationCategories parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


notificationCategoryList 


Return value of type NotificationlRPConstDefs::NotificationCategorySet 


M 


eventTypeList 


NotificationlRPConstDefs::EventTypesSet event type list 





extendedEventTypeList 


NotificationlRPConstDefs::ExtendedEventTypesSet extended event type list 





status 


GetNotificationCategories,OperationNotSupported 


M 
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Table 13: Mapping from IS getOperationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber notification irp version 


M 


operationNameProfile,ope 
rationParameterProfile 


Return of type IVlanagedGenericlRPConstDefs::IVIethodList 


M 


status 


GetNotificationlRPOperationsProfile,OperationNotSupported,lnvalidParameter 


M 



Table 14: lUlapping from IS getNotif icationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


IVIanagedGenericlRPGonstDefs::VersionNumber notification irp version 


M 


notificationNameProfile,no 
tificationParameterProfile 


Return value of type IVIanagedGenericlRPGonstDefs::MetliodList 


M 


status 


GetNotificationlRPNotificationProfile,OperationNotSupported,lnvalidParameter 


M 



5.3 Parameter mapping 



Notification IRP: IS (3GPP TS 32.302 [5]) defines the semantics of common attributes carried in notifications. This SS 
does not provide the mapping of these attributes to their CORBA SS equivalents. Other IRPs such as Alarm IRP: 
IS (3GPP TS 32. 111-2 [6]) identify and qualify these common attributes for use in their environment. Their 
corresponding SS documents define the mapping of these attributes to their SS equivalents. 



6 IRPAgent's Behaviour 

This clause describes some IRPAgent's behaviour not captured by IDL. 

6.1 Subscription 

IRPManager can invoke multiple attach_push, multiple attach_push_b or multiple attach_pull using 
different manager_ref erence(s). As far as IRP Agent is concerned, the IRP Agent will emit notifications to 
multiple "places" with their independent filter requirements. IRP Agent will not know if the notifications are going to 
the same IRPManager. 

If IRPManager invokes multiple attach_push, attach_push_b or attach_pull using the same 
inanager_ref erence and with an already subscribed notif ication_category, IRP Agent shall raise 
AlreadySubscribed exception to all invocations except one. 

IRPManager can invoke multiple attach_push using the same manager_ref erence and with one or more not- 
yet-subscribed notif ication_categories. In this case, if IRP Agent supports all the notification categories 
requested, IRP Agent shall accept the invocation; otherwise, it raises 
AtLeastOneNotif icationCategoryNotSupported exception. IRP Agent shall have similar behaviour for 

attach_push_b and attach_pull. 

When IRPManager is in subscription by invoking attach_push, IRPManager can change the filter constraint, using 
change_subscription_f liter, applicable to the notification categories specified in the attach_push. 

When IRPManager is in subscription by invoking attach_push_b, IRPManager can change the filter constraint 
during subscription using the OMG defined Notification Service Filter Interface. IRPManager shall not use 
change_subscrlptlon_f liter; otherwise it shall get an exception. 

6.2 IRPAgent supports multiple categories of Notifications 

IRP Agent may emit multiple categories of Notifications. IRPAgent may have mechanism for IRPManager to pull for 
notifications of multiple categories. 
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IRPManager can query IRP Agent about the categories of notifications supported by using 

get_notif ication_categories. 

IRPManager uses a parameter, notif ication_categories, in attach_push, attach_push_b and 
attach_pull to specify one or more categories of notifications wanted. 

IRPManager uses a zero-length sequence in notif ication_categories of attach_push, attach_push_b 
and attach_pull to specify that all IRP Agent supported categories of notifications are wanted. If IRPManager uses 
attach_push with zero-length sequence in notif ication_categories and if the operation is successful, 
IRPAgent shall reject subsequent attach_push operation, regardless if the notif ication_categories 
contains a zero-length sequence or one or more specific notification categories. IRPAgent shall have similar behaviour 
for attach_push_b and attach_pull. 

6.3 IRPAgent's integrity risk of attach_push_b IVIethod 

In the case that IRPAgent implements this method by extending or using OMG compliant Notification Service, the 
following IRPManager behaviour illustrates a risk to IRPAgent's integrity. 

Given the object reference (lOR) of the SequenceProxyPushSupplier (as the mandatory output parameter of the 
subject method), IRPManager can invoke SequenceProxyPushSupplier.MyAdmin method. 

IRPManager can then obtain the consumer admin object of the proxy. Then IRPManager can invoke 
ConsumerAdmin.MyChannel to get the lOR of the Notification Channel. IRPManager then can call 
EventChannel .MyFactory which will provide IRPManager the lOR of the EventChannelFactory itself. 
IRPManager can then able to invoke methods directly on the EventChannelFactory, like get_all_channels 
which lists all channel numbers and create_channel which allows IRPManager to create any number of additional 
channels. 

A malicious IRPManager can, given access to the EventChannelFactory, get a list of existing channels and start 
connecting them together at random thus compromising the IRPAgent's integrity. Deployment of this 
attach_push_b needs strong authentication and authorisation mechanism in place. 

The attach_push is mandatory. IRPAgent compliant to this IRP shall support it. 

The attach_push_b is optional. It is recommended that IRPAgent concerned with integrity risk should not support 
the attach_push_b option. 



6.4 Quality of Service Parameters 



The OMG Notification Service [2] supports a variety of Quality of Service (QoS) properties, such as reliability and 
priority, that may be expressed to indicate the delivery characteristics of notifications. The following OMG 
Notification Service QoS parameter settings shall be required when the IRPAgent uses the OMG Notification Service to 
support this SS: 

1 . The order policy shall be set to FifoOrder (First-in, First-out) [2] . 

2. The message priority shall be set to 0, i.e., no priority [2]. 

3. The Start Time Supported shall be set to false, i.e., do not use Start Time [2]. 
The Stop Time Supported shall be set to false, i.e., do not use Stop Time [2]. 



When the OMG Notification Service is not used, the IRPAgent shall provide First-in, First-out notification ordering, 
not provide message priority and not provide the support of Start Time and Stop Time. 
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Annex A (normative): 

IDL Specification (file name 

"IVIanagedGenericlRPConstDefs.idI") 

#ifndef ManagedGenericIRPConstDef s_idl 
#def ine ManagedGenericIRPConstDef s_idl 

# include "TimeBase . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: ManagedGenericIRPConstDef s 

This module contains definitions commonly used among all IRPs such as Alarm IRP . 



module ManagedGenericIRPConstDef s 
( 

Definition imported from CosTime. 

The time refers to time in Greenwich Time Zone. 

It also consists of a time displacement factor in the form of minutes of 

displacement from the Greenwich Meridian. 

typedef TimeBase : :UtcT IRPTime; 

enum Signal (OK, Failure, PartialFailure } ; 

The VersionNumber is a string that identifies the IRP specification name 
and its version number. See definition "IRP document version number 
string" or "IRPVersion" . 

The VersionNumberSet is a sequenece of such VersionNumber. It is returned 
by get_XXX_IRP_versions ( ) . The sequence order has no significance. 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 

typedef string MethodName; 

typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList; 

/'^ 

The Method defines the structure to be returned as part of 

get_supported_operations_prof lie () . The name shall be the actual method 

name (ex. "attach_push" , "change_subscription__f liter" , etc.) 

The parameter_list contains a list of strings. Each string shall be 

the actual parameter name (ex. "manager_ref erence" , "filter", etc.) 

struct Method 
( 

Me t h o dN ame n ame ; 

ParameterList parameter_list ; 
}; 

List of all methods and their associated parameters, 
typedef sequence <Method> MethodList; 

}; 

#endif 

IDL Specification (file name "ManagedGenericIRPSystem. idl") 

#if ndef ManagedGenericIRPSystem_idl 

#def ine ManagedGenericIRPSystem_idl 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: ManagedGenericIRPSystem 

This module contains definitions commonly used among all IRPs such as Alarm IRP. 
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*/ 

module ManagedGenericIRPSystem 
{ 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name. 

*/ 

exception ParameterNotSupported { string parameter; }; 

/* 

Exception thrown when an invalid parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception InvalidParameter ( string parameter; }; 

/* 

Exception thrown when a valid but unsupported parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception ValueNotSupported ( string parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

*/ 

exception OperationNotSupported {}; 

}; 

#endif 



IDL Specification (file name "Notif icationlRPConstDef s . idl") 
tifndef Notif IcationlRPConstDef s_idl 
#define Notif icationlRPConstDef s_idl 



#include "ManagedGenericIRPConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 



/* ## Module: Notif IcationlRPConstDef s 

This module contains definitions specific for Notification IRP . 

*/ 

module Notif IcationlRPConstDef s 

{ 

/* 

Define the current Notification IRP version. 

This string is used for the return value of 

get_Notif ication_IRP_versions () . 

It should be updated based on the rule of sub-clause 

titled "IRP document version number string". 

*/ 

const string NOTIFICATION_IRP_VERSION = "<to be updated using the rule>"; 

/* 

Define the parameters (in the notification header) specified in 

the Notification IRP: IS. 

*/ 

interface AttributeNameValue 

{ 

const string NOTIFICATION_ID = "a"; 

const string EVENT_TIME = "b"; 

const string SYSTEM_DN = "c"; 

const string MANAGED_OBJECT_CLASS = "d"; 

const string MANAGED_OBJECT_INSTANCE = "e"; 



/* 

It defines the notification categories. 

A notification category is identified by the IRP name and its version number. 

V 

typedef ManagedGenericIRPConstDef s : : VersionNumberSet Notif icationCategorySet; 

/* 
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It defines the notification types of a particular notification category. 

V 

typedef sequence <string> Notif icationTypePerNotif icationCategory; 

/* 

This sequence identifies all notification types of all notification 
categories identified by Notif icationCategorySet . The number of elements 
in this sequence shall be identical to that of Notif IcationCategorySet . 
*/ 

typedef sequence <Notif icationTypePerNotif icationCategory> 
Notif icationTypes Set; 

/* 

It defines a sequence of Subscriptionlds . 

*/ 

typedef string Subscriptionid; 

typedef sequence <SubscriptionId> SubscriptionldSet; 

/* 

This indicates if the subscription is Active (not suspended) , Suspended, 
or Invalid. 
*/ 

enum SubscriptionState (Active, Suspended, Invalid}; 
}; 

#endif 

IDL Specification (file name "Notif icationlRPSystem. idl") 
#ifndef Notif icationIRPSystem_idl 
#def ine Notif icationIRPSystem_idl 

# include "CosNotif yChannelAdmin . idl" 
tinclude "ManagedGenericIRPConstDef s . idl" 
tinclude "ManagedGenericIRPSystem. idl" 
#include "Notif icationlRPConstDefs . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: Notif icationlRPSystem 

This module implements capabilities of Notification IRP . 

*/ 

module Notif icationlRPSystem 

( 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetNotif icationlRPVersions { string reason; }; 

exception GetNotif icationlRPOperationsProf lie { string reason; }; 

exception GetNotif icationlRPNotificationProf lie { string reason; }; 

exception Attach { string reason; }; 

exception DetachException ( string reason; }; 

exception GetSubscriptionStatus { string reason; }; 

exception ChangeSubscriptionFilter { string reason; }; 

exception GetNotif icationCategories { string reason; }; 

exception SuspendSubscription { string reason; }; 

exception ResumeSubscription ( string reason; }; 

exception GetSubscriptionlds ( string reason; }; 

exception AlreadySubscribed (}; 

exception AtLeastOneNotif IcationCategoryNotSupported {}; 

interface Notif icationIRP 
{ 

/* 

Return the list of all supported Notification IRP versions. 

*/ 

ManagedGenericIRPConstDef s : ; VersionNumberSet get_notif ication_IRP_versions 

( 

) 

raises (GetNotif icationlRPVersions} ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific Notification IRP version. 
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*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_notif ication_IRP_operations_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_version 
) 
raises (GetNotif icationlRPOperationsProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem; : InvalidParameter ) ; 

/* 

Return the list of all supported notifications. 

Agent should always throw a ManagedGenericIRPSystem: :OperationNotSupported 

exception. 

Similar method, such as get_alarm_IRP_notif ication_prof ile, 

is supported in other IRP versions such as Alarm IRP . 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_notif ication_IRP_notif ication_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_vers ion 
) 
raises (GetNotif icationlRPNot if icationProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Obtain the list of all supported notification categories. 

*/ 

NotificationlRPConstDefs : :NotificationCategorySet 

get_notif ication_categories ( 

out NotificationlRPConstDefs: :Notif icationTypesSet 
notif ication_type_list 
) 
raises (GetNotif icationCategories, 

ManagedGenericIRPSystem: : OperationNotSupported} ; 

Notif icationlRPConstDef s :: Subscriptionid attach_push ( 
in string manager_ref erence, 
in unsigned long time_tick, 
in NotificationlRPConstDefs: :Notif icationCategorySet 

notif ication_categories, 
in string filter 
) 
raises (Attach, ManagedGenericIRPSystem: :ParameterNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter, AlreadySubscribed, 
At LeastOneNot if icationCategoryNot Supported) ; 

Notif icationlRPConstDef s :: Subscriptionid attach_push_b ( 
in string manager_reference, 
in unsigned long time_tick, 
in NotificationlRPConstDefs: : Notif icationCategorySet 

notif ication_categories, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPushSupplier system_ref erence 
) 

raises (Attach, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter, 
AlreadySubscribed, At LeastOneNot if IcationCategoryNot Supported) ; 

Notif IcationlRPConstDef s :: Subscriptionid attach_pull ( 
in string manager_ref erence, 
in unsigned long time_tick, 
in NotificationlRPConstDefs: : Notif IcationCategorySet 

notif ication_categories, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPullSupplier system_ref erence 
) 

raises (Attach, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter, 
AlreadySubscribed, At LeastOneNot if IcationCategoryNot Supported) ; 

/* 

Replace the present filter constraint with the one provided. 

V 

void change_subscription_f liter ( 
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in string subscription_id, 
in string filter 
) 
raises (ChangeSubscriptionFilter, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Check the current state of the subscription. 
V 

Notif icationlRPConstDef s : : Notif icationCategorySet get_subscription_status 
( 

in string subscription_id, 

out string f ilter_in_ef f ect , 

out Notif icationlRPConstDef s : : SubscriptionState subscription_state, 

out long time_tick 
) 
raises (GetSubscriptionStatus, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

Notif icationlRPConstDef s : : SubscriptionldSet get_subscription_ids { 

in string manager_ref erence 
) 
raises (GetSubscriptionlds, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Suspends the event flow until a resume is issued. 

*/ 

void suspend_subscription ( 

in string subscription_id 
) 
raises (SuspendSubscription, 

ManagedGenericIRPSystem: : OperationNotSupported) ; 

/* 

Resumes the event flow if it was suspended. 

V 

void resume_subscription ( 

in string subscription_id 
) 
raises (ResumeSubscription, 

ManagedGenericIRPSystem: : OperationNotSupported) ; 

/* 

Terminates the subscription with the agent. 

*/ 

void detach ( 

in string manager_ref erence, 

in string subscription_id 
) 
raises (DetachException) ; 



#endif 
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